Create Chat From Files

POST/v2/chats/from-files

Usage

TypeScript Example

import { v0 } from 'v0'const result = await v0.chats.createFromFiles({  files: [    {      name: 'app/page.tsx',      content: 'export default function Page() { return <h1>Hello</h1> }',    },  ],  title: 'Imported project',})console.log(result)

API Signature

Request

Request Body

files: object[]

Source files used to seed the new chat.

name: string

Path of the file in the project.

content: string

UTF-8 text content of the file.

privacy?: 'public' | 'private' | 'team' | 'team-edit' | 'unlisted'

Visibility setting for the new chat.

title?: string

Title for the new chat.

metadata?: Record<string, string>

Arbitrary key-value data to attach to the chat.

Response

chat: object

id: string

Unique chat identifier.

title?: string

Chat title, if generated.

privacy: 'public' | 'private' | 'team' | 'team-edit' | 'unlisted'

Visibility setting of the chat.

createdAt: string

ISO timestamp of when the chat was created.

updatedAt?: string

ISO timestamp of when the chat was last updated.

authorId: string

ID of the user who created the chat.

vercelProjectId?: string

Associated Vercel project ID, if any.

metadata: Record<string, string>

User-defined key-value metadata.

writePermission: boolean

Whether the caller has write access to this chat.

usage: object

Token usage and credit cost for prompt.

tokens: object

Token counts for this message.

input: number

Prompt input value (non-cached).

output: number

Completion output value.

cacheRead: number

Cache-read input value.

cacheWrite: number

Cache-write input value.

total: number

Sum of input, output, cacheRead, and cacheWrite.

creditsCost: object

Credit cost for this message.